.TH IFCONFIG 8 "10 de fevereiro de 1996" "net-tools" "Manual do Programador Linux"
.SH NOME
ifconfig \- configura uma interface de rede
.SH SINOPSE
.B "ifconfig [interface]"
.br
.B "ifconfig interface [aftype] opções | endereços ..."
.SH DESCRIÇÃO
.B ifconfig
é usado para configurar (e posteriormente manter) as interfaces de
rede. É usado durante o boot para configurar a maioria delas para
um estado usável. Depois disto, é normalmente somente necessário
durante depurações ou quando for necessária uma configuração fina
do sistema.
.LP
Se nenhum argumento for informado,
.B ifconfig
somente mostra o estado das interfaces correntemente definidas. Se
um argumento
.B interface
for informado, ele mostra somente o estado da interface informada. De
outra forma ele assume que os parâmetros devem ser configurados.
.SH Famílias de Endereçamento
Se o primeiro argumento após o nome da interface for reconhecido
como um nome de uma família de endereçamento suportada, esta família
de endereçamento é usada na decodificação e apresentação de todos
os endereços de protocolos. Atualmente as famílias de endereçamento
suportadas incluem
.B inet
(TCP/IP, default) 
.B ax25
(AMPR Packet Radio),
.B ddp
(Appletalk Phase 2),
.B ipx
(Novell IPX) and
.B netrom
(AMPR Packet radio).
.SH OPÇÕES
.TP
.B interface
O nome da interface de rede. Usualmente é um nome como
.B eth0
,
.B sl3
ou algo parecido: um nome de driver de dispositivo seguido por um
número.
.TP
.B up 
Esta flag causa a ativação da interface. É especificada
implicitamente se a interface receber um novo endereço (veja
abaixo).
.TP
.B down 
Esta flag desativa o driver desta interface, é útil quando alguma
coisa começar a ter problemas.
.TP
.B "[\-]arp" 
Habilita ou desabilita o uso do protocolo ARP para esta interface. Se
o sinal de menos (\-) estiver presente a opção é desligada.
.TP
.B "[\-]trailers" 
Habilita ou desabilita o uso de trailer em frames Ethernet. Não é
utilizada na implementação atual do pacote net-tools.
.TP
.B "[\-]promisc"
Habilita ou desabilita o modo
.B promiscuous
da interface. Isto significa que todos os frames passarão pela camada
de rede do kernel, permitindo monitoração da rede.
.TP
.B "mtu N" 
Este parâmetro configura a Unidade Máxima de Transferência (MTU) de uma
interface. Para Ethernet é um número entre 1000-2000 (o padrão é
1500). Para SLIP, use algo entre 200 e 4096. Note que a implementação
atual não manipula fragmentação IP ainda, então é melhor configurar
a MTU com um tamanho adequado!
.TP
.B "dstaddr addr"
Configura o endereço IP do "outro lado" no caso de um link Ponto-A-Ponto,
como PPP. Esta palavra-chave tornou-se obsoleta e deve ser usada a nova 
palavra-chave
.BR pointopoint .
.TP
.B "netmask addr"
Configura a máscara de rede IP para esta interface. Este valor assume o
padrão usual das classes A, B ou C (deduzindo-o a partir do endereço
IP da interface), mas pode ser configurado para qualquer valor para o
uso de sub-redes.

.TP
.B "irq addr"
Configura a linha de interrupção (IRQ) usada por este dispositivo. Muitos
dispositivos não suportam configuração dinâmica de IRQ.
.TP
.B "[-]broadcast [endereço]"
Se o argumento endereço for informado, configura o endereço de protocolo
broadcast para esta interface. De outra forma ele somente configura a flag
.B IFF_BROADCAST
da interface.  Se a palavra-chave for precedida por um sinal de menos
.B (-)
, então a flag é removida.
.TP
.B "[-]pointopoint [endereço]"
Esta palavra-chave habilita o modo
.B ponto-a-ponto
da interface, significando que ela é um link direto entre duas máquinas
sem ninguém ouvindo (ou, pelo menos nós esperamos que este seja o caso
:-)
.BR
Se o argumento endereço for informado, configura o endereço de protocolo
do outro lado do link, exatamente como a palavra-chave obsoleta
.B dstaddr
faz. De outra forma, ela somente configura a flag
.B IFF_POINTOPOINT
da interface. Se a palavra-chave for precedida por um sinal de menos
.B (-)
, então a flag é removida.
.TP
.B "hw"
Configura o endereço de hardware para esta interface, se o driver do
dispositivo suportar esta operação. A palavra-chave deve ser seguida
pelo nome da classe do hardware e o equivalente em ASCII do endereço
de hardware. As classes de hardware atualmente suportadas incluem
.B ether
(Ethernet),
.B ax25
(AMPR AX.25),
.B ARCnet
e
.B netrom
(AMPR NET/ROM).
.TP
.B multicast
Inicializa a flag de multicast para a interface. Normalmente, isto não será
necessário já que os drivers ajustam as flags corretas por si só.
.TP
.B endereço
O nome ou endereço IP da máquina (um nome de máquina será traduzido para
um  endereço IP) da interface. Este parâmetro é necessário, apesar
da sintaxe atualmente não requisitá-lo.
.SH NOTAS
Deste o kernel 2.2 não existem mais estatísticas explícitas para os apelidos (aliases)
de interfaces. As estatísticas mostradas para o endereço original são compartilhadas
como todos os endereços associados ao mesmo dispositivo. Se desejar estatísticas
por endereço você deve explicitamente adicionar regras de contabilização para os
endereços usando o comando
.BR iptables(8)
.

.SH ARQUIVOS
.I /proc/net/dev
.SH BUGS
Os endereços appletalk DDP e IPX serão mostrados, mas não podem ser alterados
com este comando.
.SH VEJA TAMBÉM
.BR route (8),
.BR netstat (8),
.BR arp (8),
.BR rarp (8),
.BR iptables (8),
.BR ifup (8),
.BR interfaces (5)
.SH AUTORES
Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
Alan Cox, <Alan.Cox@linux.org>
.SH TRADUÇÃO E REVISÃO PARA A LÍNGUA PORTUGUESA
Arnaldo Carvalho de Melo <acme@conectiva.com.br> (tradução)
.BR
Jorge Luiz Godoy Filho <jorge@bestway.com.br> (revisão)

